home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / compress / unz50x16.zip / UNZIP.DOC < prev    next >
Text File  |  1992-08-21  |  9KB  |  228 lines
  1. UNZIP(1)                 USER COMMANDS                   UNZIP(1)
  2.  
  3.  
  4.  
  5. NAME
  6.      unzip - list/test/extract from a ZIP archive file
  7.  
  8. SYNOPSIS
  9.      unzip [ -cflptuvxz[ajnoqUV] ] file[.zip] [filespec ...]
  10.  
  11. ARGUMENTS
  12.      file[.zip]  Path of the ZIP archive.  The suffix ``.zip'' is
  13.                  applied  if  the  file specified does not exist.
  14.                  Note that self-extracting  ZIP  files  are  sup-
  15.                  ported;  just  specify the ``.exe'' suffix your-
  16.                  self.
  17.  
  18.      [filespec]  An optional list of archive members to  be  pro-
  19.                  cessed.  Expressions may be used to match multi-
  20.                  ple members; be sure to quote  expressions  that
  21.                  contain  characters interpreted by the operating
  22.                  system.  See  DESCRIPTION   (below)   for   more
  23.                  details.
  24.  
  25. OPTIONS
  26.      -c  extract files to stdout/screen (``CRT'')
  27.      -f  freshen existing files (replace if newer); create none
  28.      -l  list archive files (short format)
  29.      -p  extract files to pipe; no informational messages
  30.      -t  test archive files
  31.      -u  update existing files; create new ones if needed
  32.      -v  list archive files (verbose format)
  33.      -x  extract files in archive (default)
  34.      -z  display only the archive comment
  35.  
  36. MODIFIERS
  37.      -a  convert to MS-DOS textfile format (CR  LF),  Mac  format
  38.          (CR),  Unix/VMS  format  (LF),  OR from ASCII to EBCDIC,
  39.          depending on your system (only use for TEXT files!)
  40.      -j  junk paths (don't recreate  archive's  directory  struc-
  41.          ture)
  42.      -n  never overwrite existing files; don't prompt
  43.      -o  OK to overwrite files without prompting
  44.      -q  perform operations quietly (-qq => even quieter)
  45.      -s  [OS/2,  MS-DOS]  allow  spaces   in   filenames   (e.g.,
  46.          ``EA DATA. SF'')
  47.      -U  leave filenames uppercase if created under MS-DOS,  VMS,
  48.          etc.
  49.      -V  retain (VMS) file version numbers
  50.      -X  [VMS]  restore  owner/protection   info   (may   require
  51.          privileges)
  52.  
  53. DESCRIPTION
  54.      UnZip will list, test, or extract from a ZIP  archive,  com-
  55.      monly  found on MSDOS systems.  Archive member extraction is
  56.      implied by the absence of the -c,  -p,  -t,  -l,  -v  or  -z
  57.      options.    All  archive  members  are  processed  unless  a
  58.      filespec is provided to specify  a  subset  of  the  archive
  59.      members.   The  filespec  is similar to an egrep expression,
  60.      and may contain:
  61.  
  62.      *      matches a sequence of 0 or more characters
  63.      ?      matches exactly 1 character
  64.      \nnn   matches the character having octal code nnn
  65.      [...]  matches any single character found inside the  brack-
  66.             ets; ranges are specified by a beginning character, a
  67.             hyphen, and an ending character.  If  an  exclamation
  68.             point  or  a  carat  (`!'  or  `^')  follows the left
  69.             bracket, then the range of characters matched is com-
  70.             plemented  with  respect  to  the ASCII character set
  71.             (that is, anything except the characters  inside  the
  72.             brackets is considered a match).
  73.  
  74. ENVIRONMENT OPTIONS
  75.      UnZip's default behavior may be modified via options  placed
  76.      in  an  environment  variable.   This  can  be done with any
  77.      option, but it is probably most useful with the -q,  -o,  or
  78.      -n modifiers:  in order to make UnZip quieter by default, or
  79.      to make it always overwrite or never overwrite files  as  it
  80.      extracts them.  For example, to make UnZip act as quietly as
  81.      possible, only reporting errors, one would use  one  of  the
  82.      following commands:
  83.  
  84.            setenv UNZIP -qq           Unix C shell
  85.  
  86.            UNZIP=-qq; export UNZIP    Unix Bourne shell
  87.  
  88.            set UNZIP=-qq              OS/2 or MS-DOS
  89.  
  90.            define UNZIP_OPTS "-qq"    VMS (quotes for LOWERCASE)
  91.  
  92.      Environment options are, in effect, considered  to  be  just
  93.      like  any  other  command-line options, except that they are
  94.      effectively the first options on the command line.  To over-
  95.      ride  an  environment option, one may use the ``minus opera-
  96.      tor'' to remove it.  For instance, to override  one  of  the
  97.      quiet-flags in the example above, use the command
  98.  
  99.            unzip --q[other options] zipfile
  100.  
  101.      The first hyphen is the normal  switch  character,  and  the
  102.      second  is  a  minus sign, acting on the q option.  Thus the
  103.      effect here is to cancel a single quantum of quietness.   To
  104.      cancel both quiet flags, two (or more) minuses may be used:
  105.  
  106.            unzip -x--q zipfile
  107.  
  108.      or
  109.  
  110.            unzip ---qx zipfile
  111.  
  112.      (the two are equivalent).  This may seem awkward or  confus-
  113.      ing,  but it is reasonably intuitive:  just ignore the first
  114.      hyphen and go from there.  It is also  consistent  with  the
  115.      behavior of Unix nice(1).
  116.  
  117. EXAMPLES
  118.      To  use  UnZip  to  extract  all  members  of  the   archive
  119.      letters.zip, creating any directories as necessary:
  120.  
  121.            unzip letters
  122.  
  123.      To extract all members of letters.zip to the current  direc-
  124.      tory:
  125.  
  126.            unzip -j letters
  127.  
  128.      To test letters.zip, printing only a summary  message  indi-
  129.      cating whether the archive is OK or not:
  130.  
  131.            unzip -tq letters
  132.  
  133.      To extract to standard output  all  members  of  letters.zip
  134.      whose  names  end  in ``.tex'', converting to the local end-
  135.      of-line convention and piping the output into more(1):
  136.  
  137.            unzip -ca letters \*.tex | more
  138.  
  139.      (The backslash before the asterisk is only required  if  the
  140.      shell  expands  wildcards,  as  in Unix; double quotes could
  141.      have been used instead, as in the source example below.)  To
  142.      extract  the  binary  file paper1.dvi to standard output and
  143.      pipe it to a printing program:
  144.  
  145.            unzip -p articles paper1.dvi | dvips
  146.  
  147.      To extract all FORTRAN and C source  files--*.f,  *.c,  *.h,
  148.      Makefile  (the  double quotes are necessary only in Unix and
  149.      only if globbing is turned on):
  150.  
  151.            unzip source.zip "*.[fch]" Makefile
  152.  
  153.      To extract only newer versions of the files already  in  the
  154.      current  directory,  without  querying (NOTE:  be careful of
  155.      unzipping in one timezone a zipfile created in  another--ZIP
  156.      archives  contain  no  timezone information, and a ``newer''
  157.      file from an eastern timezone may, in fact, be older):
  158.  
  159.            unzip -fo sources
  160.  
  161.      To extract newer  versions  of  the  files  already  in  the
  162.      current  directory and to create any files not already there
  163.      (same caveat as previous example):
  164.  
  165.            unzip -uo sources
  166.  
  167.      In the last five examples, assume that UNZIP  or  UNZIP_OPTS
  168.      is set to -q.  To do a singly quiet listing:
  169.  
  170.            unzip -l file
  171.  
  172.      To do a doubly quiet listing:
  173.  
  174.            unzip -ql file
  175.  
  176.      To do a standard listing:
  177.  
  178.            unzip --ql file
  179.  
  180.      or
  181.  
  182.            unzip -l-q file
  183.  
  184.      or
  185.  
  186.            unzip -l--q file
  187.  
  188.      (extra minuses don't hurt).
  189.  
  190. TIPS
  191.      The current maintainer, being a lazy  sort,  finds  it  very
  192.      useful to define an alias ``tt'' for ``unzip -tq''.  One may
  193.      then simply type ``tt zipfile'' to test the  archive,  some-
  194.      thing  which  one  ought  make  a habit of doing.  With luck
  195.      UnZip will report ``No  errors  detected  in  zipfile.zip,''
  196.      after which one may breathe a sigh of relief.
  197.  
  198. SEE ALSO
  199.      funzip(1),  zip(1),  zipcloak(1),  zipinfo(1),   zipnote(1),
  200.      zipsplit(1)
  201.  
  202. AUTHORS
  203.      Samuel H. Smith, Carl Mascott, David P. Kirschbaum, Greg  R.
  204.      Roelofs,  Mark  Adler,  Kai  Uwe  Rommel, Igor Mandrichenko,
  205.      Johnny Lee, Jean-loup Gailly; Glenn  Andrews,  Joel  Aycock,
  206.      Allan  Bjorklund,  James  Birdsall,  Wim Bonner, John Cowan,
  207.      Frank da Cruz, Bill Davidsen, Arjan de Vet, James Dugal, Jim
  208.      Dumser,  Mark  Edwards, David Feinleib, Mike Freeman, Hunter
  209.      Goatley, Robert Heath, Dave  Heiland,  Larry  Jones,  Kjetil
  210.      J{ob  Kemp, J. Kercheval, Alvin Koh, Bo Kullmar, Johnny Lee,
  211.      Warner Losh, Fulvio Marino, Gene McManus, Joe Meadows,  Mike
  212.      O'Carroll,  Humberto  Ortiz-Zuazaga,  Piet W. Plomp, Antonio
  213.      Querubin Jr., Steve Salisbury,  Georg  Sassen,  Jon  Saxton,
  214.      Hugh Schmidt, Martin Schulz, Charles Scripter, Chris Seaman,
  215.      Richard Seay, Alex Sergejew, Cliff Stanford,  Onno  van  der
  216.      Linden, Jim Van Zandt, Antoine Verheijen, Paul Wells.
  217.  
  218. VERSIONS
  219.      v1.2  15 Mar 89  Samuel H. Smith
  220.      v2.0   9 Sep 89  Samuel H. Smith
  221.      v2.x  fall 1989  many Usenet contributors
  222.      v3.0   1 May 90  Info-ZIP (DPK, consolidator)
  223.      v3.1  15 Aug 90  Info-ZIP (DPK, consolidator)
  224.      v4.0   1 Dec 90  Info-ZIP (GRR, maintainer)
  225.      v4.1  12 May 91  Info-ZIP
  226.      v4.2  20 Mar 92  Info-ZIP (zip-bugs subgroup; GRR, maint.)
  227.      v5.0  xx Aug 92  Info-ZIP (zip-bugs subgroup; GRR, maint.)
  228.